home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / comm / net / AMarquee1_43.readme < prev    next >
Text File  |  1997-05-03  |  7KB  |  136 lines
  1. Short:    AmiTCP data broadcast library & server
  2. Author:   jfriesne@ucsd.edu (Jeremy Friesner)
  3. Uploader: jfriesne@ucsd.edu (Jeremy Friesner)
  4. Version:  1.43
  5. Type:     comm/net
  6. Replaces: comm/net/AMarquee1.41.lha
  7. Requires: Workbench 2.04+, AmiTCP3.0b+
  8.  
  9. ----------------------------------------------------------------
  10.         
  11.                           AMARQUEE V1.43
  12.                      
  13.                         (Released 4/27/97)
  14.                      
  15. ----------------------------------------------------------------
  16.  
  17.  
  18. The Problem: 
  19.  
  20.  You have a great idea for a killer multi-player Internet game 
  21.  or multi-user net app, but it's a total pain in the @)#$* to 
  22.  write all the TCP connection and data synchronization code 
  23.  you'll need to get it going.  So you put your idea on the 
  24.  back-burner and go play "MineSweeper" instead.  And thus the 
  25.  Amiga is deprived of a fun Internet app.  D-oh!  :(
  26.  
  27. The Solution:  (well, okay, it's *a* solution, anyway)
  28.  
  29.  Enter AMarquee.  AMarquee is a system that handles all of
  30.  the icky information distribution details for you, allowing
  31.  you to concentrate on coding your application, rather than on 
  32.  which data goes into which socket when.  AMarquee consists of
  33.  a shared library and a TCP daemon, which work together to
  34.  get your data where it needs to be.  Your program simply
  35.  calls amarquee.library functions to broadcast the data,
  36.  and waits on a provided MsgPort for data from other hosts.
  37.  Easy!
  38.  
  39. Features of amarquee.library (the shared library/API):
  40.  
  41.  - Works with AmiTCP, Miami, or any other stack that is "AmiTCP compatible".
  42.  - Simple API that requires no knowledge of socket programming to use.
  43.  - Each AMarquee connection you make automatically and transparently
  44.    starts a seperate execution thread, so your app will never
  45.    be forced to wait while data is sent or received.
  46.  - An arbitrary number of connections may be active at once.
  47.  - Allows you to "subscribe" to data that interests you, so that
  48.    when the data is changed you will be automatically notified.
  49.    You never need to poll for anything!
  50.  - An easy mechanism for sending messages to one or many other
  51.    AMarquee clients that are logged into the same server.
  52.  - Standard Amiga wildcarding is supported in all applicable functions.  
  53.    This allows you to easily and succinctly refer to one host or data 
  54.    item, or many, as appropriate.
  55.  - Includes and several small example applications included.
  56.  - Operation is almost totally asynchronous for efficiency, but
  57.    several easy synchronization methods are available if you need them.
  58.  - Can also be used for direct client-to-client connections and
  59.    for making inetd-launched daemons.
  60.    
  61. Features of AMarqueed (the AmiTCP server):
  62.  
  63.  - Works with AmiTCP, Miami, or any other stack that is "AmiTCP compatible".
  64.  - Fully multithreaded design, with one server process per connection.
  65.  - Re-entrant code, to minimize memory usage.
  66.  - Data is stored in a filesystem-like tree structure for simplicity,
  67.    flexibility and efficiency.  Each client gets its own "home directory"
  68.    that it may write to or read from, and each client may also
  69.    read from the "home directories" of other clients.
  70.  - Efficient design minimizes CPU usage, net bandwidth, and execution time.
  71.  - Limits may be put on memory usage, number of connections, and/or 
  72.    which clients or apps may connect.  Only serve the hosts and apps
  73.    you want to serve!
  74.  - Supports data streaming to one or many clients at once.
  75.  - Data streaming and synchronization features let you be sure your 
  76.    data was read by all interested hosts before you update it again.
  77.  - Automatically detects and eliminates "dead" connections (e.g.
  78.    if the client computer was shut down without quitting politely)
  79.  
  80. WHAT'S NEW IN VERSION 1.43:
  81.  
  82. 1.43 : (Public Release 4/27/97) (amarquee.library v43)
  83.  * amarquee.library's QMessage freeing system had a design
  84.    flaw that was causing Enforcer hits and memory leaks.  Fixed that,
  85.    and as a side effect, FreeQMessage is now much more efficient.
  86.  * Fixed a bug in QFreeSession that would cause it to deadlock
  87.    and hang the calling process when freeing QSessions that were
  88.    allocated with QNewHostSession.
  89.  * Fixed some typos, layout errors, and anachronisms in the .guide file.
  90.  
  91. Note that the server program, AMarqueed, has not changed in this
  92. release.  Only the client side, amarquee.library has been updated.
  93.  
  94.  
  95. ============================= Archive contents =============================
  96.  
  97. Original  Packed Ratio    Date     Time    Name
  98. -------- ------- ----- --------- --------  -------------
  99.     1233     595 51.7% 28-Apr-97 00:00:00  AMarquee.info
  100.    89058   27153 69.5% 28-Apr-97 00:00:02 +amarquee.guide
  101.     1542    1096 28.9% 28-Apr-97 00:00:02 +AMarquee.guide.info
  102.    16612    9014 45.7% 28-Apr-97 00:00:02 +amarquee.library
  103.     4366    1998 54.2% 28-Apr-97 00:00:00 +AMarquee.readme
  104.      835     268 67.9% 28-Apr-97 00:00:00 +AMarquee.readme.info
  105.    34132   18486 45.8% 28-Apr-97 00:00:00 +AMarqueed
  106.     4123    1604 61.0% 28-Apr-97 00:00:02 +EditTextFile.rexx
  107.    10176    5932 41.7% 28-Apr-97 00:00:04 +AMarqueeDebug
  108.     6016    2041 66.0% 28-Apr-97 00:00:04 +amarqueedebug.c
  109.     9200    5494 40.2% 28-Apr-97 00:00:06 +AMarqueeHost
  110.     4175    1563 62.5% 28-Apr-97 00:00:04 +amarqueehost.c
  111.    11868    6922 41.6% 28-Apr-97 00:00:08 +AMarqueeServer
  112.     5307    1924 63.7% 28-Apr-97 00:00:04 +AMarqueeServer.c
  113.     7400    4731 36.0% 28-Apr-97 00:00:04 +BounceCount
  114.     2910    1167 59.8% 28-Apr-97 00:00:06 +BounceCount.c
  115.      247     172 30.3% 28-Apr-97 00:00:08 +dmakefile
  116.    10408    6410 38.4% 28-Apr-97 00:00:04 +MiniIRC
  117.     6379    2171 65.9% 28-Apr-97 00:00:08 +MiniIRC.c
  118.     6984    4444 36.3% 28-Apr-97 00:00:04 +RemoveTest
  119.     2546    1035 59.3% 28-Apr-97 00:00:08 +RemoveTest.c
  120.     9324    5734 38.5% 28-Apr-97 00:00:06 +SillyGame
  121.     8214    2586 68.5% 28-Apr-97 00:00:08 +SillyGame.c
  122.     7404    4711 36.3% 28-Apr-97 00:00:06 +StreamCheck
  123.     3132    1242 60.3% 28-Apr-97 00:00:08 +StreamCheck.c
  124.     7216    4569 36.6% 28-Apr-97 00:00:06 +StreamGen
  125.     2422    1018 57.9% 28-Apr-97 00:00:06 +streamgen.c
  126.     7456    4717 36.7% 28-Apr-97 00:00:04 +SyncTest
  127.     3250    1302 59.9% 28-Apr-97 00:00:08 +SyncTest.c
  128.     2162     579 73.2% 28-Apr-97 00:00:10 +AMarquee_protos.h
  129.      808     307 62.0% 28-Apr-97 00:00:12 +amarquee.fd
  130.     2470    1091 55.8% 28-Apr-97 00:00:10 +AMarquee.h
  131.     1166     372 68.0% 28-Apr-97 00:00:12 +AMarquee_pragmas.h
  132.    12811    4030 68.5% 28-Apr-97 00:00:02 +Install_AMarquee
  133.      612     329 46.2% 28-Apr-97 00:00:02 +Install_AMarquee.info
  134. -------- ------- ----- --------- --------
  135.   303964  136807 54.9% 28-Apr-97 12:30:38   35 files
  136.